home *** CD-ROM | disk | FTP | other *** search
/ Compendium Deluxe 2 / LSD and 17bit Compendium Deluxe - Volume II.iso / a / asiutils / asi-fd3.dms / asi-fd3.adf / Runit_V1.8 / RunIt.doc / RunIt.doc
Text File  |  1994-12-17  |  18KB  |  421 lines
  1. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  2. %          RunIt version 1.8          %
  3. %      Updated: 12th March 1994       %
  4. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  5.  
  6. %%%%%%%%%
  7. % NOTE: %
  8. %%%%%%%%%
  9.  
  10.  You may be thinking, wasn't RunIt coded by Software Solutions?
  11.  Well YES & NO, i used the Software Solutions alias to release utilities
  12.  to the Scene/Public domain while i was cracking, but now that I'm leaving
  13.  the cracking scene and going LEGAL, there is no need for the SS name.
  14.  
  15.  I wont be back, the only place you will see the N.O.M.A.D name is on
  16.  this and future utilities, i have not cracked any games since January 94.
  17.  I wont crack any games in future, my modem is gone, my phonelines are
  18.  being cut, and I'm off to University/College in September 1994.
  19.  
  20.  To all my friends, and to all the people i have ever had the pleasure
  21.  of meeting/talking to in the last 5 years:
  22.                                           
  23.                                         Take Care & Keep the Dream Alive
  24.  
  25. %%%%%%%%%%%%%%%%%%%%%%
  26. % Version 1.8 notes  %
  27. %%%%%%%%%%%%%%%%%%%%%%
  28.  
  29.  I have totally rewritten a lot of routines in this release of RunIt.
  30.  Because of the nature of many of the older RunIt routines ( 1.0 to 1.7 )
  31.  they were written to hit the hardware, however now that i have more
  32.  time on my hands after my decision to quit the cracking scene and go
  33.  LEGAL i have been able to take a good look at the available library 
  34.  routines and write OS legal code for most of the options.
  35.  
  36.  All routines should now work on those 68040 machines they failed so
  37.  miserably on before :)
  38.  
  39.  New options in this release:
  40.  
  41.  SCRVGA          - Forces programs to open screens in VGA mode
  42.  SCRPRODUCTIVITY - Forces programs to open screens in PRODUCTIVITY mode
  43.  SYSPAL          - Patches the Graphics.library to think it is PAL
  44.  SYSNTSC         - Patches the Graphics.library to think it is NTSC
  45.  
  46.  Runit is now workbench compatible, once you know what options will
  47.  make a game run, create a project icon with default tool RUNIT
  48.  and add the options in the tool types.
  49.  
  50.  A few examples are included in the archive
  51.  
  52. %%%%%%%%%%
  53. % About: %
  54. %%%%%%%%%%
  55.  
  56.  Runit is a degrader type tool that allows you to run all those old
  57.  software titles that refuse to work on newer machines
  58.  
  59.  DO NOT distributed RunIt without this document file.
  60.  Runit is charityware, if you use it, please give help to those in need.
  61.  
  62. %%%%%%%%%%
  63. % Usage: %
  64. %%%%%%%%%%
  65.  
  66.  Runit can be used in the startup-sequence as a cli command or used
  67.  from the cli/shell as a tool to run game/utility boot blocks that
  68.  refuse to work on 680x0 or newer machines such as A1200/4000/3000
  69.  
  70.  Tested on kickstarts 1.2 to 3.x, and should work on all future kicks
  71.  
  72.  Runit with no options will display a help screen explaining the
  73.  options available, i will describe here in what circumstances
  74.  they may need to be used.
  75.  
  76.  It does not matter what order you type the options in.
  77.  
  78.  
  79. --------------------------------------------------------------------------- 
  80.  NOCACHE   - Use this option if diskloads fail, graphics corrupt
  81.              or if programs crash for no reason
  82. ---------------------------------------------------------------------------
  83.  SCRBLANK  - Have you ever noticed how using the boot options 
  84.              screen sometimes causes screens to be corrupted?
  85.              or when software that ran from workbench on kick 1.x
  86.              has corrupted screens on kick 2.x / 3.x.
  87.  
  88.              Also use this option if the colours appear wrong
  89.              when running the game on your AGA machine!
  90.  
  91.              This option opens a Fake 1.x screen and blanks it until
  92.              the software in question opens its own.
  93. ---------------------------------------------------------------------------
  94.  SPRITE    - If your sprites are corrupt / to large / small use this 
  95.              option to reset them to normal resolution
  96. ---------------------------------------------------------------------------
  97.  FAKEFAST  - An enhanced version of FAKEMEM, this will give you
  98.              512k chip / rest of chip ram: classed as fast ram: on
  99.              1meg + chip machines.
  100.  
  101.  HALFFAST -  Same as FAKEFAST except gives 1024k of chip mem + rest of
  102.              your chip mem is classed as slow fast, this is only useful
  103.              on machines with 2meg chip or more
  104.  
  105.  
  106.  MINFAST -   Same as FAKEFAST except gives 1536k of chip mem + rest of
  107.              your chip mem is classed as slow fast, this is only useful
  108.              on machines with 2meg chip or more
  109.  
  110.  
  111.          All the fake fast options are useful in HD install versions
  112.          of various games that refuse to work with nofast or
  113.          that lockup and crash for no reason.
  114.       
  115.              Use this when "no fast mem" requesters appear, or when
  116.              games just lock, because of no fast mem.
  117.  
  118.              Remember this resets the machine the first time it is run
  119.              so any other options on the command line will be ignored
  120.              first time, but will function correctly next time they
  121.              are called.
  122. ---------------------------------------------------------------------------
  123.  SCR???   -  If you have a piece of software that REFUSES to open its
  124.              screens in the monitor of your choice, use this option.
  125.  
  126.              Currently supported Monitors are VGA and PRODUCTIVITY
  127.              
  128.              SCRVGA          = Force all software to open its 
  129.                                screens in VGA mode.
  130.  
  131.              SCRPRODUCTIVITY = Force all software to open its screens
  132.                                in PRODUCTIVITY mode.
  133.  
  134.              NOTE: The relevant monitor drivers MUST be available.
  135.                    I.E. in the devs/monitors drawer on your SYS: disk
  136.                    or you can "add" then to the monitor list by Double
  137.                    clicking on then in your Storage/monitors drawer
  138. ---------------------------------------------------------------------------
  139.  SYSPAL   -  Patches the Graphics Library to make it think it is running
  140.              on a PAL machine, use this option if PALMODE fails.
  141. ---------------------------------------------------------------------------
  142.  SYSNTSC  -  Patches the Graphics Library to make it think it is running
  143.              on a NTSC machine, use this option if NTSCMODE fails.
  144. ---------------------------------------------------------------------------
  145.  NTSCMODE -  Ever noticed that annoying gap at the bottom of some
  146.              softwares screens, try this option! 
  147.              ECS chipset or above needed.
  148. ---------------------------------------------------------------------------
  149.  PALMODE  -  Returns you to normal screen mode    
  150.              ECS chipset or above needed.
  151. ---------------------------------------------------------------------------
  152.  OLDKICK  -  Because of certain changes in kick 2.x, 3.x, certain
  153.              games failed when libraries returns were slightly
  154.              different to those on kick 1.x, this routine patches
  155.              these to return old 1.x values.
  156.              Try these on games such as Silkworm IV, Saint Dragon ETC.
  157. ---------------------------------------------------------------------------            
  158.  SET???   -  This needs some explaining, what it does is to select the 
  159.              chipset you specify, if that chipset is available, or can be
  160.              Mimic`d then the system / hardware is told to use that chipset.
  161.              at present AGA can mimic the OLD & ECS chipsets, use this 
  162.              option when GFX / Sound corrupt etc.
  163.  
  164.              You could also use this option under AGA to speed up GFX 
  165.              routines that use the operating system.(Use SETAGA or SETBEST)
  166.  
  167.              SETOLD  = Select/Mimic OLD chipset
  168.              SETECS  = Select/Mimic ECS chipset
  169.              SETAGA  = Select/Mimic AGA chipset
  170.              SETBEST = Use the best chipset available
  171. ---------------------------------------------------------------------------
  172.  VBASE    -  Use this option if games fail to load, no music etc.
  173. ---------------------------------------------------------------------------
  174.  NEWVBASE -  I have noticed that some games put code around the $c0 
  175.              memory area, while this is ok for most games
  176.              that disable the operating system, it will cause a lot
  177.              of problems for HD installable software that does not!
  178.              Use this option if for NO reason a game locks up or fails
  179.              to function correctly on your 680x0 machine, but works fine
  180.              on a 68000 based one!
  181. ---------------------------------------------------------------------------
  182.  CHIP512K -  Many programs fail when more than 512k chip memory is 
  183.              available, especially demos, try this option if a game
  184.              or demo/etc fails to load on your 1meg+ chip machine
  185. ---------------------------------------------------------------------------
  186.  NOFAST   -  Its stupid isn't it, I've seen some NEW programs that have 
  187.              been written for the A1200/A4000 that HATE fastram when 
  188.              present and just lock up when its around, try this option 
  189.              if all else fails!
  190. ---------------------------------------------------------------------------
  191.  BORDER   -  This routine is for those BADLY written intuition programs
  192.              that cause problems in certain screen modes / monitors.
  193.              These problems only occur on kick 3.x+ machines.
  194.              Great for Genlock problems!
  195.              
  196.              There are no hard fast rules about this option, you could
  197.              just use it to improve clarity on your WB.
  198.              
  199.              It will create a Black border around the screen area on 1st
  200.              running, run it again to return to normal screen mode!
  201. --------------------------------------------------------------------------
  202.  FM????      Experimental code, the AGA chipset allows the custom chips
  203.              to FETCH data from chip ram at variable rates up to 4 x the
  204.              standard rate is available, this is not compatible with all
  205.              software and will cause screen corruption.
  206.              If it does work on your software, the 680x0 has more time
  207.              allocated to it, so therefore will run faster.
  208.              
  209.          FMSYNC   = Experimental code, any reports on whether this
  210.                     works ok would be helpful, i don't have a
  211.                     multisync monitor!
  212.  
  213.              FMNORM   = Standard fetch rate 
  214.              FMDOUBLE = 2 x Fetch rate
  215.              FMTRIPLE = 3 x Fetch rate
  216.              FMQUAD   = 4 x Fetch rate
  217. --------------------------------------------------------------------------
  218.  DEGRADE  -  A lot of people asked for this, what it does is 
  219.              calls the nocache/scrblank/fmnorm/sprite/oldkick/setold/vbase
  220.              routines in this program, but all in one simple command!
  221.           
  222.              For those of you who are lazy or HATE typing :)
  223.  
  224.          Use this option if you are unsure why the software crashes
  225.           
  226.              NOTE: You can still add other options on the command line.
  227. ---------------------------------------------------------------------------
  228.  CLEAR    -  Resets machine if Virus or other contamination present.
  229. ---------------------------------------------------------------------------
  230.  FILTER   -  Turns off the low pass filter, this will make sounds
  231.              clearer and sharper.
  232. ---------------------------------------------------------------------------
  233.  HIGHBOOT -  Runit was originally written only as a cli command, but
  234.  LOWBOOT     its options were also useful for NONDOS disks i.e. games.
  235.  EXPBOOT     I found the boot options screen did not help all the time.
  236.              These 3 options were added so that a disk in df0: can be
  237.              booted with any of the options above.
  238. ---------------------------------------------------------------------------
  239.  
  240.  
  241.  Remember that runit can be used in a startup-sequence or used to boot
  242.  NON DOS disks, in this respect i think it is unique.
  243.  
  244. %%%%%%%%%%%%%%%%%
  245. % Some Examples %
  246. %%%%%%%%%%%%%%%%%
  247.  
  248.  You have installed a game from floppy on your HD, but when running
  249.  the game locks, or says not enough mem
  250.  copy Runit to your hd, add these lines to the softwares startup-sequence
  251.  
  252.  Try : RunIt Halffast ScrBlank Sprite
  253.  Or  : RunIt Minfast Sprite SetOld
  254.  
  255.  
  256.  You have installed a game from floppy on your HD, but when running
  257.  the games screens are corrupted, even though they ran ok from floppy
  258.  copy Runit to your hd, add these lines to the softwares startup-sequence
  259.  
  260.  Try : RunIt ScrBlank Sprite
  261.  Or  : RunIt ScrBlank Sprite SetOld
  262.  
  263.  
  264.  GFX & sprites / sound are corrupt
  265.  
  266.  Try : RunIt Nocache Sprite scrblank setold          
  267.  Or  : Runit Nocache Sprite scrblank setold Vbase
  268.  
  269.  
  270.  Games memory reports fail and refuses to load i.e. Silkworm (Nondos)
  271.  
  272.  Try : RunIt scrblank oldkick Highboot
  273.  Or  : RunIt scrblank oldkick Lowboot
  274.  
  275.   
  276.  If you are unsure why the game fails and is standard dos
  277.  Copy Runit to your disk, and add these lines to the startup-sequence
  278.  
  279.  Try: Runit Degrade 
  280.  Or : Runit Degrade Fakefast
  281.  
  282.  If it is NONDOS i.e. No files, cannot be dir`ed
  283.  
  284.  Try : RunIt Degrade Highboot
  285.  Or  : RunIt Degrade Lowboot
  286.  Or  : Runit Degrade Expboot
  287.  Or  : Runit MinFast then Runit degrade Expboot
  288.       
  289.  
  290.  If it still fails to load, try a mixture of options!
  291.  
  292.  Remember if the game is NONDOS use HighBoot / LowBoot / expboot options
  293.  
  294.  If you can alter the startup-sequence, copy runit to the disk and
  295.  insert the Runit command call + options in the startup-sequence!
  296.  
  297. %%%%%%%%%%%%
  298. % Reminder % 
  299. %%%%%%%%%%%%
  300.  
  301.  RunIt is charity ware, if you use it, give help to those in need, 
  302.  in whatever way you wish, whether it be putting money in collection tins, or clothes to charity shops, etc.
  303.  
  304. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  305. % RunIt's history - Versions 1.0 to 1.8 %
  306. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  307.  
  308.  V1.0a The Initial release
  309.  
  310. --------------------------------------------------------------------------
  311.  
  312.  V1.1a Bug fixed release
  313.  
  314.  Minor bug in the scrblank routines caused copper corruption / crashes
  315.  in certain circumstances, this has now been fixed.
  316.  
  317.  Recoded, now totally pc relative
  318.  
  319. --------------------------------------------------------------------------
  320.  
  321.  V1.2 Added new options + colour :)
  322.  
  323.      OLDKICK option added, helps with software incompatibility on 2.x,
  324.              3.x Kickstarts
  325.      SET???  option added, select OLD / ECS / AGA or BEST chipsets 
  326.              helps with GFX bugs, etc
  327.      
  328.      Memory routines rewritten for future Kickstart compatibility
  329.      
  330. --------------------------------------------------------------------------
  331.  
  332.  V1.3 added new option - Sprite & recoded scrblank routines
  333.  
  334.      SPRITE   option added, helps stop sprite corruption on AGA &
  335.               ECS chip based machines
  336.                            
  337.      SCRBLANK option has been re-written - its screen / chipregs
  338.               setup are now as close to 1.x as possible
  339.                      
  340. --------------------------------------------------------------------------
  341.  
  342.  V1.4 added two new options - Vbase and Degrade + scrblank recoded again!
  343.  
  344.      VBASE    option added, helps stop mysterious crashes etc
  345.      
  346.      DEGRADE  option added, combines all the options needed to get
  347.               those stubborn games to run in one command!
  348.              
  349.      SCRBLANK option altered to also reset colour selection reg in 
  350.               AGA to palette #1,stops the wrong colours appearing! 
  351.  
  352. --------------------------------------------------------------------------
  353.  
  354.  V1.5 - lets just ignore this one eh!-Butchered 1.4 version by THOMAS!/SP
  355.  
  356. --------------------------------------------------------------------------
  357.  
  358.  V1.6   A bug that crept into NTSCMODE & PALMODE from version 1.3 has 
  359.         been fixed, In some circumstances they just failed to work!
  360.      
  361.      Added four new options Newvbase - Chip512k - Fastoff - Border
  362.       
  363.  
  364.      NEWVBASE  option added, helps stop crashing/lockups on software
  365.                that puts code at lower memory areas that are usually
  366.                reserved for 680x0 vector
  367.                
  368.      CHIP512K  option added, Turns off all chip ram > 512k
  369.      
  370.      FASTOFF   options added, Turns off all fast ram
  371.      
  372.      BORDER    option added, colours border colour to 0, toggle back
  373.                to normal screen mode by running again
  374.      
  375. --------------------------------------------------------------------------
  376.  
  377.  V1.7  Another bug, when using runit in a script that selected fakefast
  378.        after the reset and runit being called again with the fakefast
  379.        option, FASTOFF was called as well, bug removed!
  380.        FASTOFF is now called NOFAST because of this!
  381.        
  382.        Four new options added HALFFAST / MINFAST / FM???? / EXPBOOT
  383.        
  384.      HALFFAST  option added, for those 2meg+ chip users, gives you
  385.                1024k chip + rest of chip ram classed as slow fast.
  386.  
  387.      MINFAST  option added, for those 2meg+ chip users, gives you
  388.                1536k chip + rest of chip ram classed as slow fast.
  389.                
  390.      FM????    option added, can free up the 680x0 in non AGA specific
  391.                software, allowing it to run at up to 4 x faster
  392.                MSYNC options allows 15hz screens to be displayed on 31hz
  393.                monitors ( experimental code )
  394.  
  395.      EXPBOOT   option added, HIGHBOOT & LOWBOOT still failed to boot
  396.                certain software from DF0:, so i added another option
  397.                that would boot from FAST ram ( can be FAKEFAST ) 
  398.                HIGHBOOT or LOWBOOT fail, try this option!
  399.  
  400. --------------------------------------------------------------------------
  401.  V1.8  Most routines rewritten in a more OS friendly manner.
  402.        A lot of bugs have been removed!
  403.  
  404.        Runit is now workbench compatible, once you know what options will
  405.        make a game run, create a project icon with default tool RUNIT
  406.        and add the options in the tool types.
  407.  
  408.        4 new options added  SCRVGA / SCRPRODUCTIVITY / SYSPAL / SYSNTSC
  409.  
  410.        SCR???  Forces screens to open via the specified monitor
  411.  
  412.        SYSPAL  Patches the graphics.library to think it is running on a
  413.                PAL machine
  414.  
  415.        SYSNTSC Patches the graphics.library to think it is running on a
  416.                NTSC machine
  417.       
  418. %%%%%%%%%%%%%%%%%%%%%%%%
  419. % End of Document file %
  420. %%%%%%%%%%%%%%%%%%%%%%%%
  421.